Skip to main content
PATCH
/
v1
/
kyc
/
customers
/
{subaccountId}
Tier Two | Add/Update Individual Information
curl --request PATCH \
  --url https://api.bullring.finance/v1/kyc/customers/{subaccountId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "first_name": "Mike",
  "middle_name": null,
  "last_name": "Bull",
  "phone": "+2348012345678",
  "address": {
    "street_line_1": "9 Karimu Street",
    "street_line_2": "",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "105102",
    "country": "NGA"
  },
  "birth_date": "1993-01-24",
  "account_purpose": "PAYMENTS_TO_FRIENDS_OR_FAMILY_ABROAD",
  "account_purpose_other": null,
  "employment_status": "EMPLOYED",
  "expected_monthly_payments_usd": "FROM_5000_TO_9999",
  "acting_as_intermediary": false,
  "most_recent_occupation": "ACCOUNTANT_AND_AUDITOR",
  "source_of_funds": "INHERITANCE",
  "documents": [
    {
      "purpose": "PROOF_OF_ADDRESS",
      "file": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ],
  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "NGA",
      "number": "12345678909",
      "image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png",
      "image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ]
}
'
{
  "status": "not_started",
  "created_at": "2025-11-21T15:32:51.901Z",
  "updated_at": "2025-12-31T10:17:21.319Z",
  "type": "individual",
  "first_name": "Mike",
  "middle_name": null,
  "last_name": "Bull",
  "phone": "+2348012345678",
  "address": {
    "street_line_1": "9 Karimu Street",
    "street_line_2": "",
    "city": "Lagos",
    "state": "LA",
    "postal_code": "105102",
    "country": "NGA"
  },
  "birth_date": "1993-01-24T00:00:00.000Z",
  "documents": [
    {
      "purpose": "PROOF_OF_ADDRESS",
      "file": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ],
  "account_purpose": "payments_to_friends_or_family_abroad",
  "account_purpose_other": null,
  "employment_status": "employed",
  "expected_monthly_payments_usd": "FROM_5000_TO_9999",
  "acting_as_intermediary": false,
  "most_recent_occupation": "ACCOUNTANT_AND_AUDITOR",
  "source_of_funds": "inheritance",
  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "NGA",
      "number": "12345678909",
      "image_front": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738198/verification/2025-11-21/t2fgqlxesqigmm0qfvbi.png",
      "image_back": "https://res.cloudinary.com/bullring-finance/image/upload/v1763738205/verification/2025-11-21/n0slzbkhxreppmqew4yd.png"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
subaccountId
string<uuid>
required

The unique identifier of the subaccount

Body

application/json
​
first_name
string
​
middle_name
string | null
​
last_name
string
​
phone
string

Phone number of the customer. Must be in E.164 format (e.g., +2348012345678)

​
address
object
​
birth_date
string<date>

Must be formatted as YYYY-MM-DD

​
account_purpose
enum<string>
Available options:
CHARITABLE_DONATIONS,
ECOMMERCE_RETAIL_PAYMENTS,
INVESTMENT_PURPOSES,
OPERATING_A_COMPANY,
OTHER,
PAYMENTS_TO_FRIENDS_OR_FAMILY_ABROAD,
PERSONAL_OR_LIVING_EXPENSES,
PROTECT_WEALTH,
PURCHASE_GOODS_AND_SERVICES,
RECEIVE_PAYMENT_FOR_FREELANCING,
RECEIVE_SALARY
​
account_purpose_other
string | null
​
employment_status
enum<string>
Available options:
EMPLOYED,
HOMEMAKER,
RETIRED,
SELF_EMPLOYED,
STUDENT,
UNEMPLOYED
​
expected_monthly_payments_usd
enum<string>
Available options:
UP_TO_4999,
FROM_5000_TO_9999,
FROM_10000_TO_49999,
FROM_50000
​
acting_as_intermediary
boolean
​
most_recent_occupation
string

Fetch from occupation endpoint: /api-reference/verification/get-occupations

​
source_of_funds
enum<string>
Available options:
company_funds,
ecommerce_reseller,
gambling_proceeds,
gifts,
government_benefits,
inheritance,
investments_loans,
pension_retirement,
salary,
sale_of_assets_real_estate,
savings,
someone_elses_funds
​
documents
object[]
​
identifying_information
object[]

Response

200 - application/json

Customer information updated successfully

​
status
string
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
type
string
​
first_name
string
​
middle_name
string | null
​
last_name
string
​
phone
string
​
address
object
​
birth_date
string<date-time>
​
documents
object[]
​
account_purpose
string
​
account_purpose_other
string | null
​
employment_status
string
​
expected_monthly_payments_usd
string
​
acting_as_intermediary
boolean
​
most_recent_occupation
string

Fetch from occupation endpoint: /api-reference/verification/get-occupations

​
source_of_funds
enum<string>
Available options:
company_funds,
ecommerce_reseller,
gambling_proceeds,
gifts,
government_benefits,
inheritance,
investments_loans,
pension_retirement,
salary,
sale_of_assets_real_estate,
savings,
someone_elses_funds
​
identifying_information
object[]